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Summary 

DETEF 

This DECtape file-handling system provides the user with a key¬ 
board monitor similar to the DISK/DECtape Monitor, though bet¬ 
ter suited to DECtape operation. 

Based on a data-controlled linking loader, this monitor will 
address any tape unit and any memory field while occupying only 
the last memory page of field zero. The DECtape hardware is 
used in continuous mode reading and writing, the core-specifi¬ 
cations being word-, not page-wise. Program files as well as 
data files are relocatable continuous block sequences, easy to 
create and to retrieve by user programming. Files are addressed 
by 5-character names and are classified as to type by means of 
a sixth letter. The system directory will accomodate 63 user 
files on each tape reel. 

A special feature is a system of generating library files, or 
segmented programs. 

Requirements: PDP8/I, 4k, EAE, and TC01 DECtape control. 

Optional: Extended Memory, High-Speed Reader and Punch. 

System application programs to the DETEF include:- 

(1) A 4k Focal version having versatile program and data library 
capabilities: segments of program and data files may be saved 
and loaded by programmed instructions, thus virtually elimin¬ 
ating the limits on program size set by core dimension. 

( 2 ) An Editor allowing the merging of text from several sources 

(DECtape files and punched tape) and automatic return of 
edited text to one of the input files. The listings carry 
line numbers. _.. 

( 3 ) A PAL Assembler with output to DECtape, control of extent of 
assembly listing, and optional extension of the symbol table 
by storage on DECtape. 
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THE DECTAPE FILE-HANDLING SYSTEM, DETEF 

USER'S MANUAL 

Author: Carl Reutersward* 

Date: Apr. 14, 19T2 (submitted to the DECUS Program Library) 

I, System Specifications 

_K_Purpose 

The DETEF System was designed as a general punched-tape and DEC- 
tape file monitor for a 4k PDP8/I computer. It permanently occu¬ 
pies only the last 128 locations of this memory field and thus 
performs the same functions as the DEC Disk/DECtape Monitor. How¬ 
ever the design emphasizes a smooth, rapid operation of the DEC- 
tape device and supplies the user with a permanently avail.able 
general DECtape handler. It does not use the instruction, ION. 

By Teletype keyboard commands, the DETEF monitor enables the user 
to load programs by punched tape or similarly structured assembler 
output files into any memory field. The loaded programs may be 
saved as core-images in DECtape files and reloaded and started by 
a call command. DECtape blocks may be allocated for programs and 
data of several kinds and deleted for retrieving DECtape space. 

The files are addressed by the DECtape transport unit number, a one- 
letter type-designation, and a five-character name. The file-direc¬ 
tory of each a tape reel accomodates 63 user-files. 

The system DECtape handler operates the TC01 control in the con¬ 
tinuous mode by counting words, not blocks. The transfer to the 
core memory may be controlled by data stored in the blocks, by 
which linking of separate block sequences may be achieved. The 
files generated by the monitor, however, constitute contiguous 
sequences of blocks, thus ensuring rapid call operations. They 
are completely relocatable on the tapes. 

♦ Address: FOA 1, P.O.Box Ul6, S-172 04 Sundbyberg, Sweden. 
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2 JL _Genera.l_S^stem_LaL^—ou.t 

(1) The minimum system configuration is: 

Computer PDP8/I, 4k, with Teletype ASR33, 

Extended arithmetic unit (EAE), 

DECtape control TC01/08 and one transport unit TU55/56. 

(2) Possible extensions are: 

Extended memory control MC8/I and up to seven additional 4k units. 
Seven additional transports TU55/56, 

High speed punched tape reader and punch PT8/I. 

(3) The monitor instructions are stored in block 0 and blocks 13 - 
31 of the tape on the DECtape transport No. 0/8 (the System Unit). 
The blocks 1-12 are used for temporary storage of user program 
residing in core locations utilised by the monitor. The System 
Unit has thus to be operated in the "Write Enabled" mode. 

(4) By simple modifications, however, the monitor may be instructed 
to utilise another transport for the temporary saving of user pro¬ 
gram. The System Unit may then be operated under "Write Lock", pro¬ 
tecting the system monitor from destruction. 

(5) Blocks 32 - 34 of each tape store the system directory of files 
on the tape. 

(6) The system loader permanently occupies locations 76 OO - 7777 of* 
memory field zero. When the monitor is called into operation, the 
data of locations 5200 - 7577 are replaced by monitor instructions. 
During monitor operations, other instructions and the contents of 
file directories are loaded into this core area. When control is 
returned to a user program (or the command "EXIT" is given), the 
saved data are returned (if not intentionally changed by the monitor 
operation). 
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(7) The monitor preserves the data stored in the last page of any- 
extended memory unit. The user may profitably store a binary loader 
in one such page, if available, before loading the DETEF system. 

(8) For operation of the system, these programs are essential: 

INDEX 

PACK 

PCOPY 

BFILE 

They are saved as C-files and their location on the tape is free. 

(9) The blocks and locations allocated to the several system seg¬ 
ments are presented in Appendix No. 1. 
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II. System Generation 

J_. When a System DECtape is available, a new System tape is gen¬ 
erated by applying the command "SYSTEM”. For further directions, 
refer to the chapter "Monitor operation". 

The freshly generated system tape contains only the monitor rou¬ 
tines and a directory. To be fully operable, the system must be 
complemented by the programs INDEX, PACK, FCOPY and BFILE, cop¬ 
ied from the generating system (refer to paragraph FCOPY in the 
chapter "System Programs"). 

2 . A System DECtape is generated by the DETEF Builder binary 
punched tape. The procedure is as follows: 

(1) Ascertain that there is a Binary Loader in any core field 
(No. "f"). 

(2) Mount a correctly formatted DECtape reel (2702g blocks of 

201o word each) on a transport, unit No. 8, with switches 
o 

set to "Remote" and "Write Enabled". 

(3) Put the program tape in the Teletype (L.S.) or the High 
Speed (H.S.) reader, with leader code (200) in reading pos¬ 
ition. 

(U) Set switches to: I.F. = f, D.F. = 0, S.R. = 7777, press 
"Load Add" switch. 

(5) If H.S. reader be used, set S.R. to 3777* 

(6) Press "Start" switch. 

(7) If L.S. reader be used, set this to "Start". 

(8) Part of the tape is read in; when program halts, check that 
the AC register is cleared (if not, restart procedure from (l)) 

(9) Set I.F. to 0 and S.R. to 200; press "Load Add" and then con¬ 
sol switch "Start". 

(10) Program stops at HLT in location 201. 

(11) If L.S. reader is used, set bit zero of S.R. to 1; press switch 
"Cont". 

(12) The remainder of the tape is read in, and the system will be 
stored on the DECtape. 
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(13) Finally the DETEF Bootstrap Loader is automatically read into 
locations 775 1 * - 7766 and started; the monitor will he called 
from the newly generated system and show its presence by print¬ 
ing a carriage return (C.R.)» a line feed (L.F.) and a period 

at the left margin of the Teletype. It is now awaiting 
a command from the Teletype keyboard. 

(14) Punched tape reading errors lead to JMP . at location 215 with 
AC cleared. Restart from (l). 

(15) DECtape hardware errors during BUILDER operation lead to a HLT at 
location 127, or a JMP . at 126 with the B Status word in the 
AC. Check the DECtape switches and restart from (l). 

(16) Further programs are added to the system from binary program 
tapes, one at a time, by applying the commands "LOAD" and "SAVE". 
Refer to next chapter. 
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III. Monitor Operation 


r 


(1) When the monitor exits from core, either by starting a user 
program or merely by halting after a "EXIT" command, the sys¬ 
tem loader is left in the last page of core field zero. The 
monitor is then recalled by starting at 7777 (set I.F. — 0, 

D.F. = 0, S.R. = 7777i press "Load Add" and "Start"). 

(2) If the 1-page System Loader is not present, the start may be 
achieved by toggling in the 11 codes of the DETEF Bootstrap 
Loader in the core field zero as listed in Appendix 2. This 
routine is started at 7756. 

(3) The DETEF System may be loaded and started by the Disk/DECtape 
monitor or the PS/8 Programming System by a routine also listed 
in Appendix 2. 
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2 . Monitor_Commands* 

(1) When the monitor has printed at the left margin, it is 
ready to receive a command. 

(2) ALLOCATE 

This command reserves a sequence of blocks for a file. The 
format of the command is this represents a carriage re¬ 
turn): 

^ALLOCATE t u name!n;a) (for C- and L-files) 

^ALLOCATE t u name In) (for other file-types) 

u = DECtape transport unit No. (0 to 7» 0 stands for 8). 
t = file-type (one alphabetic letter) 
name: 1 to 5 alphanumeric characters 
n = octal number of blocks 
a = starting address 

By this command the following entries are written into the sys¬ 
tem directory of the specified unit: name, type, 1:st block no., 
no. of blocks, starting address (when applicable). 

When this has been effected, the monitor reports: 

DONE 


(3) DELETE 

When a file is to be scratched from a system directory, the 
format of the command is: 

•DELETE t u name) 

The monitor eliminates the allocation entries pertaining to 
the file specified, and then reports: 

DONE 

The blocks thus set free may be utilized for further allo- 

****««« 

existing files are to be eliminated, use the program PACK. 

* In the following examples of TTY operations, underlined charac 
ters are printed under program control. 
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(4) LOAD 

Binary program tapes and files of similar structure (B-files) 
are loaded by means of the following dialogue with the monitor: 
AjOAD /terminate by a space, not "i " 

HjR,T,Du:name,... .1 /specify 0 to 8 inputs 

L^....i /same 

^aj 

a = starting address in field zero 
R stands for the H.S. reader 
T stands for the Teletype reader 
D stands for DECtape (a B-file of name specified) 
u = unit No. 

H asks for inputs to high addresses (5200 - 7577) in field 
zero 

L asks same for low addresses (0 - 5177) 

Addresses in extended memory fields are treated as low. 

Then the inputs are read into core in the order specified. The 
reading of each punched tape is initialised by the print-out 
of the character "f"» the user puts the tape into the reader 
and answers by typing a CTRL/P character. HLTs (7^02) will be 
deposited in all locations of field zero which are not used. 

When loading is complete, a "f” appears, again to be answered 
by a CTRL/P. The monitor then exits and transfers control to 
the address given ("a") in field zero . If a = 0, the monitor 
remains and enters Command Mode. 

(5) SAVE 

A program residing in the core may be saved on a DECtape unit 
by this command format: 

^SAVE u f name!h-k,l-m,....;a) 

DONE 

u = DECtape transport unit no. (0 to 7) 
f = core field no. 

h-k, etc., are core space specifications given in ascending 
order 

a - starting address in core field zero 
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A maximum number of 6 core specifications may be given, all 
in one core field. 

The SAVE routine operates in two passes: first are those in¬ 
structions saved, which belong to the "low" part (0 - 5177) 
of core field zero and those in extended core fields, secondly 
come those in the "high" part (5200 - 7577). 

The files generated are C-files and automatically allocated 
by the SAVE command. They are core images and will be loaded 
by the "CALL" command, which also automatically start execution 
at location a. 

(6) CALL 

The user types: 

_jCALL u f name) 

u = DECtape unit no. (0 to 7) 
f = core field no. 

The monitor reads the contents of blocks 1 to 12 of the system 
device into the field zero locations 5200 to 7577 > by which the 
monitor ceases to exist in core. The loader in j600 - 7777 then 
reads the called program into the field specified in the call 
and finally transmits control to the field zero address given 
at save-time. 

If the user intends to immediately continue monitor operation, 
the starting address should be given as 7777• The monitor will 
at once be reloaded, and several call-commands may be given, 
e.g. for loading into several core fields. 

Stating 77^5 as the starting address will leave the system at a 
' HLT in this location. 
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(7) LIBRARY 

Large programs and program systems may be segmented and conveniently 
created and called by this command. The files addressed in this way 
must be allocated as L-files. A L-file may be described as a collec¬ 
tion of C-files. Of these, the only one to be started by the monitor 
is that one beginning at the first block of the L-file (relative 
block no. zero). The other parts of the program are called through 
program operation in any way the programmer chooses. 

(a) A L-file is created in the following way. 

The program segments which are to be the components of the L-file 
shall exist saved as C-files. The allocation of blocks to the L-file 
is done with a dummy starting address, e.g. 7777. Then: 


^LIBRARY u name) 
#ADD u:name!b) 

# 


/name of the L-file 
/name of a C-file 
/etc. 


u = DECtape transport unit no. (0-7) 
b = relative Ist-block no. within the L-file 
The monitor copies each C-file into the specified place (b) within 
the L-file. The relative Ist-block numbers must be chosen with due 
regard to the size of each C-file so that these do not overlap. 

The C-file specified with b * 0 will have its starting address im¬ 
posed as the entry point of the L-file. The system will no longer 
recognize the interior programs as C-files. 

(b) A L-file is called by unit no. and name as above, and then: 

*G0) 

The code ulOO is deposited at location 7775 and the starting block- 
number of the L-file at 7776 of field zero. Then the first program 
in the file is loaded and started. 

(8) SYSTEM 

This command represents the easiest way of generating a new system 
DECtape. 

Mount a correctly formatted tape on a transport with any number from 
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1 to 7 , set switches to "Remote", "Write Enabled", and type: 

^SYSTEM ONTO UNIT:u l 
TITLE t namej 

f_ (check the switches and type a CTRL/P) 

DONE 

• 

The title should be given by 1 - 5 alphanumeric characters. It 
will appear in the directory print-out obtained from the program 
INDEX. 

(9) EXIT 

This command (terminated by a space!) effects the loading of the 
contents of blocks 1 to 12, thereby restoring the user program 
saved at the previous loading of the monitor (if not destroyed 
by operation of the LOAD command) and finishing with HLT in 
7744. 

The system Loader remains in the last page of field zero. This 
loader is not usable for loading punched tapes. The common 
PDP8 RIM and Binary Loaders may be loaded only by calling a 
special program, which loads the instructions into the last 
page after monitor exit. 

(10) General rules for typing monitor commands: 

(a) Command words may be limited to two characters; always ter¬ 
minate with a space. 

(b) Typing errors are amended by typing a Line Feed and restart 
from begin. 

(c) u = 0 or f = 0 need not be typed; if f 4 s °> however, also 

a u = 0 must be typed. Thus: 

CALL INDEX instead of CALL 0 0 INDEX; 

CALL 7 PALD instead of CALL 7 0 PALD; 
but not CALL 1 SABR1 for CALL 0 1 SABR1. 

(11) General remarks on handling of the linking loader. 

Since the linked loading is governed by the control words in 
the first block of each file segment, files can cause trouble 
when not properly formatted by a saving or initializing pro¬ 
cedure, which should be performed right after allocating. 
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IV. Programming with DETEF 


li_y£iIiziSS_the_Sjrstem_DECta2e_handler 

The System Loader in the last page of field zero comprises a sub¬ 
routine for effecting DECtape transfers which can be utilised by 
the user program. The calling sequence in PAL-D notation is: 

JMS I (7626 
PAR 

JMP DTERR /Error exit; Status B in the AC 

PAR, ulfc /u = unit no.; f = field no.; c = 0 for read, = 1 for 
write 

block /Ist-block no. 

wc /- (no. of words) 

ca /(1st address)-1 

link 

The parameter 1 (bit 6 of parameter word ulfc) controls the auto¬ 
matic linking facility: 

1=0 gives normal transfer with 201g word per block: 

read and write starts at begin (word 0) of 1st block; 

wc determines number of words in the transfer: 

ca determines begin of core segment involved 

(the parameter link is not used, buffer location not needed) 

1 = 1 gives linked loading. When writing, the words wc, ca, and 
link, will be saved as the 3 first word of transfer (not 
counted in wc), the others following as in the case' of 1 = 0. 
The link gives the distance in block numbers to the next seg¬ 
ment of the file. 

When reading a segmented file with 1=1, only ulfc and block 
need be specified. The loader first reads the three words wc, 
ca, and link, into their locations, and then uses wc and ca 
as parameters for the transfer. The user program can utilize 
the link for coding the transfer of next segment. 

The error exit will normally be achieved when a hardware error is 
encountered. However, a write-lock condition when using the DECtape 
handler for writing in the linking mode will lead to a closed loop 
at 7715-7720 with 7775 in the AC and the transport halted. 
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2. DECtape_Errors 

(1) When using the Bootstrap Loader, a tight loop at 7761 - 7762 
may occur. The loading of the System Loader was unsuccessful. 
Correct erroneous switches on the DECtape transport and re¬ 
start the Bootstrap at 7756. 

(2) A HLT in the System Loader location 77^5 indicates an error 
before loading of the monitor; Status B is in the AC. 

Correct DECtape switches and restart at 7777. 

(3) When the Monitor is in operation, a DECtape error will lead to 
the diagnose: '?$' and a tight loop at 7^12; Status B is in the 
AC. Strike the Space key for continuation. 


3_ 1 _B-files 

(1) The structure of these files is similar to those of the bi¬ 
nary program tapes• They represent a means of saving on DEC— 
tape the data of such tapes having a complicated loading pat¬ 
tern, since the SAVE command can deal with maximally only 6 
origin settings. They are generated by the system program 
BFILE, or could be the output of a suitably modified PAL as¬ 
sembler. 

The DETEF B-file conforms to the pattern of binary files of 
the Disk/DECtape Monitor System by packing three 8-bit codes 
in two 12-bit words. Thus three program instructions occupy 
four data words in the B-file. Except origins, field designa¬ 
tions, checksum, and program data, the B-file comprises start 
and end codes corresponding to the leader/trailer codes of 
the binary tape, and, additionally, the control words for op¬ 
erating the linking loader. 

The LOAD command expects the file segments to be loaded with¬ 
in the core section, 6200 - 6777* 
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4. Ending_user_grograms 

If the user programs ends up with a JMP I (7777* the monitor will 
automatically be started. Alternatively, the user program may end 
with a JMP I (77U5, resulting in a HLT, from which the monitor 
can be called by pressing the switch 'Cont . 

5. Write-Lock_on_the_system_unit 

In order to eliminate the need for operating the system device in 
the "Write Enabled" mode the following patches have to be made in 
the system tape: 


0, loc. 

l4: 

change 1 to 

1001 

16 

11 

0 

1000 

16 

15 

0 

1000 

20 

165 

0 

1000 

2k 

122 

0 

1000 


Now the user core saving routine will utilize unit no. 1, which 
must always be present and operated in the "Write Enabled" mode. 
The unit no. 0/8 can be "Write Locked". 

The directory located in blocks 32 - 3k of each system tape can 
be read and searched by DISUB, three subroutines listed in Appen¬ 
dix 3. They occupy lU5g words in one memory page and may be as¬ 
sembled together with a user program after specifying the three 
constants: 

CODSTA = 1st address of DISUB 

BUFSTA = 1st address of a 3-page buffer 

FILTYP ■ the ASCII code of the file-type character. 

The App. 3 gives further details on the structure of the directory 
and a sample program for utilising the DISUB—routines. 
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* V. System and Ancillary Programs 

A list of core allocations of these programs is given in App. 1+. 

1. INDEX 

This program will produce a directory of files allocated on a DETEF 
system tape. User intervention is called twice: 

(1) to give the DECtape unit number and add a string of commenting 
text (such as the calendar date, etc.). 

(2) to expand the listing to include numeric file parameters, such 
as first block number (FBLK), the number of blocks (BLKS), and 
the program entry point (in the case of 'C' and 'L* files). 

Refer to Appendix 5 for a sample listing. 

2. PAC K 

The DELETE command leaves unused gaps in the block sequence of a 
tape. These are eliminated by the PACK routine. The operation is 
straight-forward as in this example: 
jCALL PACKi 

PACK UNIT 2 ON TO UNIT 5i 

$_ /check DECtape unit switches, then hit CTRL/P 

DONE 

PACK UNIT /CTRL/C for return to monitor 

If DECtape error occurs, the program will type out ’?$XXXX', where 
XXXX represents the B Status word. If the error occurred during 
a file transfer operation, there will, in addition, appear four 
octal words, giving the parameters of the IODT call: ulfc, block, 
wc, ca (cf., paragraph IV.1). 

3 i _FC0PY 

Copies the contents of one file into another file, which must have 
been allocated as the same type and at least the same number of 
blocks as the original. This is a sample dialogue: 
j^CALL FCOPY t 

/File-type 
/Receiving file 

IN-D 7:XFILJ /Original file 

1 /Check DECtape unit switches, then hit CTRL/P 

TYPE- 

DECtape errors will be diagnosed as in the program PACK. 
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k. BFILE 


This program converts the data of a saved program (a core image) 
to the format which is required by the LOAD command for use in 
loading simultaneously with punched tape binary program data as 
needed for complex overlay operations. The contents of three pro¬ 
gram locations will be packed into four B-file data words. 

The B-file is structured into 3-block segments, having a capa¬ 
city of 41+0 program instructions (including origin settings). The 
start and end of program data will be marked by one leader/trailer 
code (200) in each case. No field-setting is given. 

Before calling the program BFILE, the user must have allocated a 
B-file of sufficient capacity (one-third larger than the C-file 
in consideration). 

In executing BFILE, the user answers the questions "OUT-D" and 
"IN-D" by typing a DECtape unit number, a colon, a file-name, 
and a carriage return. The program will then start operating. 

When finished, it will type out and restart the initial¬ 
izing dialogue. 

The diagnosis, ”?FE", will indicate that the B-file is too small. 
A DECtape error will be signalled by "?$" and the B Status word. 

5 i _0EDT 

This Octal Editor of DECtape loads one block into the core memory 
for the purpose of inspection and changing single words or list¬ 
ing in entirety. Then the updated data may be saved in the same 
block. The dialogue runs thus: 

U: The user types the DECtape unit number, and a "i " 

B: The user types the octal block number, and a 
Li_ A "J" given here will result in a 8-column listing of the 129 
words in the block 

L: The user may inspect and update the contents of the buffer in 

the ODT manner by typing a "/" and an octal location number 
(0 - 200), reading the contents of the location and changing 
these by typing a 12-bit word. Terminating the line with a 
line-feed will open the following location for inspection; 
a 'V" will put an end to this procedure. 
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L£ By typing "S", the user will save the updated data into the 

old block and restart the procedure from "U:". (The command S will 
not be accepted if the unit number stated is 0 or 8.) An "u” or a 
"B" will end the operations on the current block without saving the 
buffer contents. 

U: The program is interrupted by typing CTRL/C. 


6._tdupl 

This program utilizes the System Loader subroutines in the last 

page of field zero for duplicating an entire DECtape reel. The 

commands are given as in this example: 

XALL TDUPLJ 

1:03 /The user types the DECtape unit number 

/of the original 

Q:7J /The copy appears on the unit specified 

/here 

_f /Check the commands and switches; then 

/hit CTRL/P 
/Duplicating is done 

I: /Go next duplicating operation or hit 

/CTRL/C for returning to the system mon- 
/itor 

DECtape error diagnoses are like those of the program PACK. 


7. PTCOR 

This program may assist in giving a correct command for saving 
programs loaded as binary tapes. It will read such a tape and 
type out a core-list, showing into which core locations the pro¬ 
gram is loaded. 

When first started, the program will ask: 

R/T? 

The user indicates which reader is to be used* 

The program then types: 

1 

and the user responds with CTRL/P after loading the 

reader with the tape (leader code in reading position). The pro- 
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gram starts reading the tape and types origins as ”*nnnn”, field 
designations as ’^n”, and core-specifications as "nnnn - nnnn", 
five in each line. 

The operation ends by the output "t": the user may start another 
run, or finish by hitting CTRL/C, which calls the system monitor. 

8 ._CFPT 

This "C-File to Punched Tape” copying program converts a C-file 
to a binary program tape. When called, CFPT will ask: 

R/T? 

The user states whether the high-speed punch (R) or the teleprinter 
(T) should be used. Then the question: 

IN-D 

is answered by typing the DECtape unit no., a colon, the name of 
a C-file and a carriage return. The program types: 

i 

and the user puts the punch ”on”, and hits CTRL/P. 

The program will then start punching, ending by again typing: 

1 

The user puts the punch ”off” and hits CTRL/P. The program should 
then restart by asking ”R/T?”. At this point the diagnose: 

XXXX BLOCKS 

will indicate, that the copied program did not use all the blocks 
of the file. 

Other messages output by CFPT are the following: 

?F = Format error: an illegal file-name was typed 
?H = Name error: no such file in the directory 

?D ■ Data error: the program in the file cannot be properly read 
?$XXXX = DECtape error: XXXX * B Status word. 
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Appendix 1:1 


Core allocations of Monitor instructions 


7777i 








SYSTEM LOADER 


7600 





7^00 

- USER 


MONITOR 

- 


PROGRAM 


COMMAND 


7200 




— 

7000 




• • 

6600 








DIRECTORY 


64oo 




- 

6200 





6000 









ALLOCATE, 



5600 



- DELETE, - 

- LOAD - 

- SYSTEM - 




SAVE 


GENERATOR, 

5400- 





* 





LIBRARY 

5200 







I 


200 

0 
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Appendix 1:2 


block allocations of detef system 




0 

SYSTEM LOADER _ 

1 


2 

SAVE 

3 

BUFFER 

A 

FOR 

5 

USER 

6 

PROGRAM 

7 

LOCATIONS 

10 

5200-7577 

1 1 


12 

' 

13 


14 

MONITOR COMMAND 

15 


16 


1 7 


20 

ALLOCATE 

2 1 

delete# save 

22 


23 


24 

LOAD 

25 


26 


27 


30 

SYSTEM GENERATOR 

31 

LIBRARY - 

32 


33 

DIRECTORY 

34 


35- 


RELOCATABLE SYSTEM * 


USER PROGRAMS# 


data files 

-2701 
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DETEF System Starters 


Appendix 2 


DETEF SYSTEM 
BOOTSTRAP LOADER 


7754 

7755 

ENTRY POINT--— 7756 

7757 

7760 

7761 

7762 

7763 

__ 7764 

- 7 765 

7 766 


0000 

7577 

6774 

1365 
6766 
6771 
5361 

1366 
5360 
0600 
0220 


0200 

7602 

///DETEF SYSTEM STARTER 
/(DISKSYS) 

*200 

DTFBS# CLA HLT /CHANGE SYSTEM TAPE REEL 

0201 

6774 

DTLB 

0202 

3633 

DCA I VC 

0203 

1227 

TAD MOVB 

0204 

4222 

JMS DWAIT 

0205 

1230 

TAD K7577 

0206 

3634 

DCA I CA 

0207 

1220 

TAD M200 

0210 

3633 

DCA I VC 

0211 

1231 

TAD REDF 

0212 

4222 

JMS DVAIT 

0213 

1232 

TAD K200 

0214 

6764 

DTXA 

0215 

6772 

DTRB 

0216 

7510 

SPA 

0217 

7402 

HLT 

0220 

7600 

M200# 7600 /CLA 

0221 

5620 

JMP I .-1 

0222 

0000 

DVAIT# 00 

0223 

6766 

DTCA DTXA 

0224 

6771 

DTSF 

0225 

5224 

JMP .-1 

0226 

5622 

JMP I DVAIT 

0227 

0600 

MOVB# 600 

0230 

7577 

K7577# 7577 

0231 

0220 

REDF# 220 

0232 

0200 

K200# 200 

0233 

7754 

VC# 7754 

0234 

7755 

CA# 7755 
/ 

















Appendix 3:1 

Listings of the subroutines_DISUB 

and a sample coding for utilising these for loading and searching 
the Directory. 


0001 


t 

4 

0008 


CLA 

■ J ■? *. \ ■_ 1 . ^ . 

0003 


TAD UCODE 


0004 


AND C7000 


0005 


JUS 1 (DIRED 

/LOAD THE DIRECTORY 

0006 


JMP DTERR 

/DECTAPE ERROR1 STATUS B IN AC 

0007 


JMS I CDIGET 

/GET THE FILENAME AND CARR*RETURN 

0008 


JMP GERROR 

/TOO MANY CHARACTERS! 0 IN AC 

0009 


JMS I (D1SER 

/SEARCH DIRECTORY 

0010 


JMP SERROR 

/FILE NOT IN DIRECTORY! 0 IN AC 

0011 


DCA STBLA 

/ADDRESS OF PARAMETER STBL 

0012 


TAD STBLA 


0813 


DCA PTR 

■ . / ' 

0014 


TAD I PTR 

•r ■ • ' . • ( 

0015 


DCA UCODE+1 

■ '■) ,■■ ’ i.-f: 

0016 


1SZ PTR 

• . 1 * :i . ' . i ‘ • • 

0017 


TAD X PTR 

, • ? * 

0018 


MQL MUY 


0019 


801 


. 0080 


CIA 


0081 


DCA UCODE+2 


0028 


JMS X (XODT 

/IODT-7626 

0083 


UCODE 


0084 

V 

JMP DTERR 

/DECTAPE ERROR! STATUS B IN AC 

0085 


t /DATA 

LOADED 

0086 


1 


0087 

STBLA* 

00 


0028 

PTR# 

00 


0029 

tlC ODE# 

U0P0 /U-UNIT MO*# F-FIELD NO* 

0030 


00 /STBL-MO* OF FIRST BLOCK 

0031 


00 /VC"MINUS COUNT OF WORDS IN DATA FILE 

0032 


DATBUF-1 

/DATBUF-FIRST LOCATION OF DATA- BUFFER 

0033 


t 


0034 

/DIRED-CODSTA# DISER-CODSTA+7# DXGET-CODSTA+58 

0035 

/FILTYP 

-304 
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XLIST 

PAUSEC ODSTA-200 

BUFSTA-7000 

FILTYP-304 

///DISUB# ROUTINES FOR READING AND SEARCHING THE DIRECTORY 
/(DETEF> 

♦CODSTA , 

/DIRED SUBROUTINE! READS THE DIRECTORY INTO THE BUFFER 

/CALLING SEQUENCES 
/ TAD UNIT 
/ CLL RTR 
/ RTR 

/ JMS I (DIRED/ 

/ (DECTAPE ERROR RETURN! AC-STATUS B 
/ (RETURN! AC-0) ' 


0200 

0000 

DIRED# 00 

0201 

3603 

DCA I •♦2 

0202 

4746 

JMS I DIODT 

0203 

0335 

FUNC 

0204 

7410 

SKP 

0205 

2200 

ISZ DIRED 

0206 

5600 

JMP I DIRED 


0007 

0210 

0211 

0212 

0213 

0214 

0215 

0216 

0217 

0820 

0221 

0222 

0223 

0224 

0225 

0226 

0227 

0230 

0231 

0232 

0233 

0234 

0235 

0236 

0237 

0240 

0241 


0000 

1340 
7001 

3330 
1730 
7041 

3332 
2330 
2330 

1341 

3331 
7346 

3333 

1730 
7041 

1731 
7640 
5240 

2330 

2331 
2333 
5224 
1330 
2207 
5607 

2330 

2331 


/CALLING SEQUENCES 

/(FILENAME XXXXXT IN 3-WORD NAME-BUFFER “FILNAM") 
/ JMS 1 (DISER 
/ (ERROR RETURN! AC-0> 

/ (NORMAL RETURN! AC-ADDR•OF STBL) 

DISER# 00 
TAD DBUFF 
IAC 

DCA DPTR1 
TAD I DPTRi 
CIA 

DCA DC NT! /MHOS COUNT pF ENTRIES 
ISZ DPTRI 


1SZ DPTRI 

NXTENT# TAD MAMBUF 
DCA DPTR2 
CLL CLA CMA RTL 
DCA DCNTS 

NXTWRD# TAD I DPTRI 
CIA 

TAD 1 DPTR2 
SZA CLA 
JMP WOMATC 
ISZ DPTRI 
ISZ DPTR2 
ISZ DCNTS 
JMP NXTWRD 
TAD DPTRI 
ISZ DISER 

JMP 1 DISER /DONE 
NOMATC# ISZ DPTRI /WRONG ENTRY 
ISZ DPTR2 


/ENTRY FORMATS 
/ XX 

/ XX (ASCII-CODES - 240> 
/ XT 
/ STBL 
/ BLK5 
/ E#P* 


/ENTRY FOUND! GET ADDR* OF STBL 
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0848 

8333 

ISZ 

DC NTS 


0843 

5840 

JMP 

• -3 


. 0844 

8330 

ISZ 

DPTRI 

/SKIP STBL 

0845 

8330 

ISZ 

DPTRI 

/SKIP BLKS 

0846 

8330 

ISZ 

DPTRI 

/SKIP E*P* 

0847 

8338 

ISZ 

DCNT1 

/ALL ENTRIES EXAMINED? 

0850 

5880 

JMP 

NXTENT 

1 

0851 

5607 

JMP 

I diser /yes; ERROR RETURN 


/DIget subroutine; reads the filename from tty 
/CALLING SEQUENCES 
/ JMS I CDIGET 
/ (ERROR RETURN! AC«0> 

/ (NORMAL RETURN; AC«0; NAME a FILETYPE IN 3-WORD BUFFER) 


0858 

0000 

DIGET#- 00 

0853 

1348 

TAD M6 

0854 

3338 

DCA DCNT1 , 

0855 

1341 

TAD NAMBUF ' 

0856 

3330 

DCA DPTRI 

0857 

3334 

DCA HALF 

0860 

6031 

INPUT# KSF /READ ONE CHARACTER 

0861 

5860 

JMP *-l 

0868 

6036 

KRS ' 

0863 

6041 

TSF /PRINT IT 

0864 

5863 

JMP *-l , 

0865 

6046 

TLS 

0866 

1343 

TAD NCR /TEST IT 

0867 

7450 

SNA /CARRIAGE RETURN? 

0870 

5876 

JMP PACKT 

0871 

1344 

TAD CRMSP /NO! PACK IT 

0878 

4307 

JMS PACK 

0873 

8338 

ISZ DCNT1 

0874 

5860 

JMP INPUT 

0875 

5658 

JMP 1 DIGET /TOO MANY CHARS*; ERROR 

0876 

8332 

PACKT# ISZ DCNT1 

0877 

7410 

SKP 

0300 

5303 

JMP *+3 

0301 

4307 

JMS PACK /TILL OUT WITH ZEROS IF < 

0308 

5876 

JMP PACKT 

0303 

1345 

TAD FTYPE /PACK THE FILETYPE 

0304 

4307 

JMS PACK 

0305 

8858 

ISZ DIGET 

0306 

5652 

JMP I DIGET /DOME 

0307 

0000 

PACK# 00 

0310 

8334 

ISZ HALF /WHICH HALF? 

0311 

5316 

JMP LEFT 

0318 

1730 

TAD I DPTRI /PACK IN RIGHT,HALF 

0313 

3730 

DCA I DPTRI 

0314 

8330 

ISZ DPTRI 

0315 

5707 

JMP I PACK 

0316 

7106 

LEFT# CLL RTL 

0317 

7006 

RTL 

0380 

7006 

RTL 

0381 

3730 

DCA I DPTRI 

0388 

7040 

CMA 

0383 

3334 

DCA HALF 

0384 

5707 

JMP I PACK 


5 CHARS* 
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0325 0000 

0326 0000 

0327 0000 

0330 0000 

033! 0000 

0332 0000 , 

0333 0000 

0334 0000 

0335 0000 

0336 0032 

0337 7200 

0340 6777 

034! 0325 

0342 7772 

0343 7563 

0344 7755 

0345 0044 

0346 7626 

BUFSTA 7000 
CODSTA 0200 
CRMSP 0344 
DBUFF* 0340 
DCNT! 0332 
DCMT2 0333 
DlflET 0252 
DlODT 0346 
D1RED 0200 
DISER 0207 
DPTRI 0330 
DPTR2 033! 
FILNAM 0325 
FILTYP 0304 
FTY|»E 0345 
FUNC 0335 
HALF 0334 
INPUT 0260 
LEFT 0316 
MCR 0343 
M6 0342 

NAMBUF 034! 
NOMATC 0240 
NXTENT 0220 
MXTVRS 0224 
PACK 0307 
PACKT 0276 


FILNAM# 00 
00 
00 

DPTRI# 00 

DPTR2 # 00 

DC NT!# 00 
DCNT2# 00 
HALF#' 00 
FUNC# 00 
32 
*600 

DBUFF# BUFSTA*! 
NAMBUF# FILNAM 
M6# *5 

MCR# *215 
CRMSP# 215*240 
FTYPE# FILTYP-240 
DXGDT# 7626 


/ASCII-CODE 



240 



» 
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Core Allocations of DETEF Ancillary Programs 


Name 

Save locations 

Entry Paint 

INDEX 

7000 - 7 U 1 U 

7000 

PACK 

7000 - 7^35 

7000 

BFILE 

20 - 1031 

200 

FCOPY 

6720 - 7565 

7000 

CFPT 

20 - 752 

200 

TDUPL 

200 - 461* 

200 

OEDT 

6600 - 7377 

6600 

PTCOR 

200 - 561+ 

200 
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Sample listing of the Directory 

(Underlined characters were typed by the user) 


• call iNOEXfc 
FILES ON UNIT 3Jk 

0014 FIL£S» 0210 BLOCKS 


NAME TYPE 

_FBLK 

BLKS 

E.P. 

OETEF 

* 

0000 

0035 


I NDEX 

C 

0035 

0003 

7000 

PACK 

C 

0040 

000 3 

7000 

BFILE 

c 

0043 

0005 

0200 

F COPY 

c 

0050 

0004 

7000 

CFPT 

c 

0054 

0004 

0200 

0 EOT 

c 

0060 

0003 

6600 

PTCOH 

c 

0063 

0002 

0200 

TDUPL 

c 

0065 

0002 

0200 

FOCAL 

L 

0067 

0040 

0200 

PALO 

L 

0127 

0041 

5000 

EDIT 

C 

01 70 

0020 

3000 

FILES 

ON 

UNIT 




Appendix 5 
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APPLICATIONS OF THE "DETEF" DECTAPE FILE HANDLING SYSTEM 
I. DETEF-FOCAL 
Carl Reutersward^ 

Date Apr. ifc, 1972 

The DETEF-FOCAL is equivalent to the FOCAL version of the TIROS 

2 ) 

Timesharing and Real-Time Operating system for the PDP8/I . It 
constitutes a modification of FOCAL W (DEC 08_—AJAC-D) specifi - 
cally intended for handling large amounts of experimental data, 
such as are obtained in spectroscopy. It utilizes program library 
files and data files on DECtape; automatic concatenation of pro¬ 
gram segments can be used to effectively remove the limits on pro¬ 
gram size inherent in bk FOCAL operation. 

DETEF-FOCAL FEATURES 

1. Sta rti ng Dialogue 

_JjI FOCAL) 

#G0 

♦XFUN-x ) 

* (The user types "N", "S" or "A" for "No", "Some" or "All" Ex¬ 
tended Functions) 

*BUFS-x xx+yyyJ (or *BUFS-x xxx), or *BUFS- ^) 

*_ (The user states size (octal) of "Data" + "Reference" buffers 

* (or "Data" buffer only); type i only if no buffers is wanted) 
*LIB-u :name) 

(The user indicates an F-file) 

*DATA-u :name,u:name) (or *DATA-u :name)) 

* (The user indicates one or two (identical or different) D-files 
as store of data) 

*_ (Focal is now in command mode. The user may start calculating, 
programming, or calling a program from the library.) 

In this dialogue, typing a rubout will cause the question to be 
repeated. 

1 ^ Address: FOA 1, P.O.Box b'\6, S-172 04 Sundbyberg, Sweden 

? ) 

Presented at DECUS 7th European Seminar, Amsterdam, Sept. 1971* 
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2^_The_Data_Buffer 

This buffer is a core area where data may be stored safe from being 
destroyed by an Erase command. This area is also directly accessible 
for transfers between the core and the D-files specified in the in- 
itialisation dialogue. 

The instruction: SET X=FBUF(l), sets the variable X equal to the 
12-bit integer stored at the buffer location I (1=0,1,...). The 
octal word 1*000 is rendered as 0. 

The instruction: SET D=FBUF(I,X), places X as a 12-bit integer 
at the buffer location I: 20l*7^X>-20l*7. (X-values outside this 
range are rendered modulo (1*096)); in this process the dummy 
variable D acquires the integer value X. 

If the buffer size has been given as x+y, then x pertains to a 
specific "Data" section and y to a "Reference" section. The num¬ 
bering of buffer locations is common to both, the "Data" section 
starting at location 0, the "Reference" at location x. 

Double-precision floating-point numbers may be stored in the buf¬ 
fer area by means of the special variable DB(l) . Each number is 
stored in three consecutive locations: 31, 31+1, 31+2. 

Since ordinarily each variable needs 5 core locations, the data 
buffer feature offers a certain economy of storage. 

3. Th e Library Command 

When a library file has been specified in the initialization, the 
contents of the Focal program buffer can be saved by the command: 
LIBRARY SAVE PROGRAM x (or L S P x) 
where x is an integer (x=0,1,...) 

The command considers x to point to the number of an 8-block seg¬ 
ment of the library file. These segments are numbered: 0,1,.... 
Reversely, the command: 

LIBRARY CALL PROGRAM x (or L C P x) 

loads the program stored in segment no. x into the program buffer, 
destroying any program residing there. The variables are destroyed 
only if necessary because of lack of space; the variables first 
defined are those first deleted. The buffer area is not effected. 
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In this connection, the user should be made aware of the import¬ 
ance of filling newly allocated program files with programs (or 
cleared text buffers) in order to avoid the troubles which acci¬ 
dentally may arise through calling a program which has not been 
saved. 

4 JL _Da.ta._File_0ger ations 

The Library command also applies to the "Data" and "Reference" 
buffers, and transfers are effected to D-files specified in the 
initialization (the first one is associated with the "Data" buf¬ 
fer, the second one to the "Reference" buffer): 

LIBRARY CALL DATA x (L C D x) 

LIBRARY CALL REFERENCE x (L C R x) 

and similarly for saving (LSDx,LSRx) 

The integer x (=0,1,...) points to the number of a segment of 
the file: if n is the number of buffer locations, then each seg¬ 
ment comprises [n/ 129 ] + 1 blocks ([x] meaning the integer part 
of a number x). 

6 _;__Programming_library_commands 

Transfers may be initiated by programmed commands. Thus the pro¬ 
grammed instruction: 

L C P IjGOTO 4.3 

will call a program from file segment no. 1 and start execution at 
line no. 4.3. In general, one instruction following the library 
command on the same line will be saved for execution after loading 
the new program. The application of this feature is illustrated 
in Appendix 1. 

5. B uf fer s ize considerations 

The maximum buffer size is 21550 locations. This is reduced step¬ 
wise by the various options as follows: 

extended functions "S": -400g "A": -6000 

program or data library: *1730 
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This function operates a storage display tube via the AX08 com- 
puter/laboratory interface. The command formats are the following 
two: 

FDIS(x,y) - illuminates a point 

FDIS(x,y,z) - z=E for Erase, S for Store, N for Non-Store. 

The program should allow a delay of 0.1 sec for execution of the 
E command before ordering a point display, as in the following 
which stores a rectangular frame display: 

1.1 S D=FDIS(,,E); S D=FDIS(,,S)v F 1=0,9; S X=0 

1.2 F Y=-255,510 ,25-5; F X=0,4,508', S D=FDIS(X,Y) 

1.3 F X=0,511,511; F Y=-252,U,252; S D=FDIS(X,Y) 

The coding of the relevant AX08 instructions is listed in Appen¬ 
dix 2. 

(1) The DETEF-FOCAL comprises an improved FRAN, which produces 
pseudo-random numbers in the range (-1, +1) with the period 
4,194,304. The initial argument of FRAN() is 20485. It can be 
changed by means of the function FSET: 

SET D=FSET(x) 

will set the initial argument of FRAN() to x; x should be an odd 
integer in the range ±2 23 , and D is a dummy variable. 

(2) The FADC has been eliminated. 

(3) The symbol of decimal exponentiation has been changed from 

"E" to This leaves the character E free for use as a nu- 

meral, e.g.: 

♦TYPE 0DEFi 
45 6 . 000 * 

(cf., the demo program of App. 1). 

(4) The command Alt. Mode has been replaced by CTRL/P. Typing 
CTRL/C as an answer will call the System Monitor. 
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(5) The High Speed Reader input is switched on and off by the 
command ”f”. 

(6) DETEF-FOCAL does not utilize the program interrupt system; 
the Low Speed Reader will never run out of synchronism with the 
program. 

(7) For a list of error messages, refer to Appendix 3. 

DETEF-FOCAL is generated by an overlay to DEC FOCALW after initial¬ 
ization. The procedure is the following: 

(1) Load the FOCALW by paper tape (two binaries in one tape) 

(2) Save 46(2(2-1+771 as FOCI; S.A. = 7777 

(3) Load FOCALW again 

(1+) Set 7402 at location 4500 using the Consol Switches 

(5) Start execution at 200; the program will halt at 4500 

(6) Save 1-7577 as FOC0; S.A. = 7777 

(7) Allocate a B-file "FOC0" of 60 blocks 

(8) Use the system program "BFILE" for converting the C-file FOC0 
into the B-file FOC0 

(9) Load the B-file FOC0 and the DETEF-FOCAL Overlay (4 binaries 
in one tape) 

(10) Save 1-7577 as FOC0; S.A. * 200 

(11) Allocate L-file FOCAL, 40 blocks, S.A. = 7777 

(12) Use the Library command to create this file: 

#ADD u:FOC0!0j 
*ADD u:F0C1! 31) 

(13) L-file FOCAL is ready for use. 

10 Core utilization of DETE F- FOCAL 

The following locations of memory field 0 are left free to the 
user of DETEF-FOCAL: 

0-3, m-175, 2372-2400, 275^-2762, 6371-6376, 7175-7177, and 

7377. 
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Application of Library calls 

The following demonstration program will call a library segment 
as a subroutine in order to evaluate the answer given by the user 
to a question put by the program. It will use segment nos. 0 and 
1 of a library file specified in the FOCAL initialization dialogue. 
The program will then be generated, saved and called into oper¬ 
ation by typing this: 

*E A 

*.1.1 ASK "TWO PLUS THREE WAKE"X;SET Y =0 

* 1 .2 L C P 1 ;go 

*.1.3 TYPE "ERROR" ! J QUIT 

*.1.4 TYPE "CORRECT"!;QUIT 

*L S P 0 

*.E A 

*.1.1 L C P Y;IE (X-0FIVE) 1 .3> 1 .4/1 .3 
*.L S P 1 

*l c p 0 ;go 
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Appendix 2 

Implementation of FDIS for AX08 as interface to. a storage display 


Function: Non-Store 

Relay outputs: R1:= 0 
R2: = 0 

Program coding: 2713 TAD C7757 
271*+ 6342 

2715 CLA 

2716 TAD C7767 
2111.6342 

2734 C7757, 7757 

2735 C7767, 7767 


Store 
R1 := 0 
R2:= -3V 
2722 TAD C20 
2123.6344 

2715 CLA 

2716 TAD C7767 
2111.6342 
2733 C20, 20 


Erase 
R1 = -3V 

2743 TAD C10 
2144.6344 
2752 C10, 10 


■r 
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Appendix 3 

8 . Summary of error messages 

The error message format is ?nn.nn 6 mm.mm} where nn.nn is the 

error code and mm.mm is the line number. 

i 

?00.00 Restart via CTRL/C and REFOC 

701iOO Restart via CTRL/P 

701*35 Group zero is an illegal line number 

?01.43 Illegal step or line number used 

?01.89 GOTO was not used as one word 

?01•;2 Line number is too large 

?01•$ 3 Double periods found in a line number 

702.48 Nonexistant line number referenced by DO 

702.63 Nonexistant group referenced by DO 
?02.81 Storage was filled by push-down list 
703*09 Nonexistant line number used or a tight loop 
703*31 Illegal command used 

704*07 No space after IP or illegal format 
704*35 Left of = in error in POR or SET 

704.48 Excess right parenthesis encountered 
704*56 Illegal terminator in POR command 

705.63 Bad argument to MODIFY 

?06.13 Illegal use of function or number 

?06.64 Storage filled by variables 

707*14 Operator missing in an expression or double E 

707*34 No operator used before parenthesis 

707*<0 Double operators used 

?07• 5 1 No argument given after function oall 

?07*j8 Illegal function name given 

708.50 Parenthesis do not match 

709.16 Bad argument in ERASE 

709*50 Maximum group number exceeded 

711.05 Illegal argument in F3TJF 

712.83 Storage was filled by program 

713.09 Illegal LIBRARY command 

713.39 Illegal program or buffer number 
713.56 Illegal LIBRARY command 

713.67 Illegal terminator after LIBRARY command 

713.94 DEC-tape error 

720.41 Logarithm of zero requested 

723.35 Literal number is too large 

723 .|8 DB subscript out of range 

726.91 Negative exponent used 

726.96 Exponent is too largo 

726.<5 DB subscript out of range 

728.58 Division by zero requested 

730.40 Imaginary square roots required 


2.11.71 
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APPLICATIONS OF THE "DETEF" DECTAPE FILE HANDLING SYSTEM 
II. DETEF-EDIT 
Carl Reutersward 1 ^ 

Date Apr. I 1 *, 1972 

The DETEF System Editor is a modification of Disk Editor (DEC-D8- 

ESAB-PB 4/24/68). The changes enable the Editor to utilize files 

2 ) 

in the DETEF File Handling system for storage of edited text 
and, further, add some operational improvements. 

1_. _The_Editor I_n£ut/Output_Files 

These are DETEF System files of type 'A' and consist of contigu¬ 
ous sequences of "blocks, grouped into segments of max. 3 blocks 
each. File space must be reserved in advance by means of the 
ALLOCATE commond. The text is packed with two 6-bit characters to 
each file location, and the number of blocks required for each 
editor page is 

t(c + 2t + 4l)/256 10 l + 1 

where: c = the number of characters, 
t = the number of tabs, 

1 = the number of lines in the page, 
and [x] denotes the integer part of x. For a program with a modest 
amount of comments this expression will not exceed [1/10] + 1. 

_2._Initijil^zatiori of_o]Deration 

The Editor is called from the DETEF System by the CALL command: 
_j_CALL EDIT) 

*0UT- 


1 Vddwsai FOA 1, P.O.Box 4lt>, S-172 04 Sundbyberg, Sweden 

“^Presented at DECUS 7th European Seminar, Amsterdam, Sept. 1971* 
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The user responds with } for no output. Til for output to the Tele¬ 
type, R} for output to the high-speed reader, and Du:xxxx Jfor 
output to an allocated A-file of name xxxx on the DECtape unit 
no. u. Typing errors may he amended after hitting the Ruhout key. 

The Editor acknowledges a correct answer hy typing a and asking 

for input. The user now specifies from zero up to seven inputs 
- Teletype reader (T), High-Speed Reader (R), or DECtape files - 
in the order in which they will he used, e.g.: 

♦IN-R .D1:ASCI ,D1: ASC2,R,2 

The Editor acknowledges each input with a and finally asks: 
♦OPT- 

The user answers (n denoting a digit): 

B (or nB) meaning: presence blanks, or 

T (or nT) meaning: replace multiple blanks with tah/rubout com¬ 
binations 

Instead of 'T*, ^ or any other letter may be used. 

The number n points to one of the inputs specified: n=1 to the 
first, etc. The Editor will finally return the output to this 
input, if these be DECtape files, using the specified output 
merely as a buffer. 

If n=0, no such returning will take place. 

The Editor types a indicating command mode. 

J3._Edit_ojr _commands (cfDEC manuals D8-ASAA-D and 08-ESAB-D) 

R command : Two or more Editor pages may be concatenated by using 
multiple R commands. If the Editor buffer (about UlOOg locations) 
then becomes full, the bell will ring and the reading is stopped 
before all of the last page is read. If DEC-tape is used for both 
input and output the next R command will not read the rest of the 
page'. 

L and S commands : When one of these commands is used, the line 
number is printed before each line. 
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X command : This is used to switch the input to the following one 
as specified in the initialization dialogue; e.g.: 

—^ /One page is loaded from input no. 1 

/Switch 

—^ / The loaded page is saved in the output, and 

/the first page of input no. 2 is loaded. 

G command : This has been deleted. 

E -_ comman d: If input is from the teletype and output is to DECtape, 
a CNTRL/FORM must be typed following the E command. If a return 
to an input file has been specified, the Editor will first save the 
last pages in the output file, then type a , and finally 
transfer the contents of the output to the designated return file. 
CTRL/P: This command during output to the teletype causes the 
Editor to stop typing and return to the command mode. 

CTRL/C : This command will cease further Editor operation and call 
the DETEF System Monitor. 

b_. _Error_p.essa.ges_ 

FE (file exceeded): This message will be written when output is 
to DECtape and the number of blocks allocated to the file is too 
small. After writing "FE" the Editor will transfer control to the 
DETEF System Monitor* 

If the output is to the file designated as the output file in the 
initialization dialogue, this file will be usable (as input) 
despite the error, but the last part or all of the last page will 
be lost. If the output is to an input file specified as the 
return file, i.e. if the message appears after the character '#» , 
then this file is not properly closed and may not be used as 
input. However, the edited data are available in the buffer file 
(designated as output file in the dialogue). 

l._Loading_and_saying the DETEF Editor 

The Editor is generated in file by loading the binary tape and 
then giving the command: 

J3AVE EDIT!1-3656;3000) 
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t applications of the "detef" dectape file handling system 

III. DETEF-PALD 
Carl Reutersward^ 

Date Apr. U, 1972 

The DETEF System Assembler is a modification of the Disk 
Assembler (DEC-D8-ASAA-LA U/25/68) enabling it to utilize 

n\ 

files in the DETEF file handling system ' for source input and 
binary output, and in addition to improve the operational 
qualities in some respects (cf. DEC manual D8-ASAA-D). 

J.._Input_files 

There are DETEF files of type A (ASCII-files) which are produced 
by the DETEF-Editor. They are loaded segment-wise into core by 
means of the DETEF Linking Loader; the buffer comprises locations 
7000-7577. The storage format is one which packs two 6-bit stripped 
ASCII-codes into each location. 

Punched paper tapes read through the Teletype Reader or the High 
Speed Reader are also accepted as inputs. A maximum of 10 sources 
are allowed for input into one assembly operation. 

2^_0utput _file_s 

The output of the assembler is paper tape punched in the Teletype 
Punch or the High-Speed Punch, or DETEF files of type B (Binary- 
files). These are made up of concatenatedsegments of max. 2 block 
each, which will be loaded into locations 6400 - 6777 by means of 
the Linking Loader. The binary data are stored packed^three 8-bit 
codes into two file locations. 

^._The_symbol table 

App. 1 gives a list of the pseudo-instructions and permanent PAL 
instructions of DETEF-PALD, 96 symbols in all. 


1) 

2 ) 


Address: FOA 1, P.O.Box Ul6, S-1720U Sundbyberg, Sweden 
Presented at DECUS 7th European Seminar, Amsterdam, Sept. 
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In operation, the user may choose between a smaller symbol table 
with a more speedy assembly, or an extended table with a slower 
assembly. 

The smaller symbol table has room for 223 user-defined symbols 
with assembly output to DECtape, or 255 with no output, or 
punched tape output. 

The extended symbol table holding a maximum of 409 user-symbols, 
is partly saved onto DECtape; during assembly these parts are 
swapped to and from the core memory, thus slowing down the process 
of assembly. However a maximum of 248 symbols may be assembled without 
any swapping. 

The saved parts of the table are stored in blocks 1-12g of DEC¬ 
tape unit no. 0 (or any other unit as defined by patching one 
instruction of the assembler). 

_3._Ass_embly operation 

DETEF-PALD is a segmented program, which modifies itself by over¬ 
lays during operation. The initialization dialogue runs as follows: 
_vLI PALD J 
#G0 i 
♦OUT- 

The use types T 3 for output (of binary) to the Teletype, R 5 . for 
the High-Speed Punch, and unit:name} for output to a DECtape 
file. Use the Rubout key for correcting a miss-spelling. 

*IN- 

The user types T, R or unit:name for each of 1 to 10 inputs, 
separated by commas and finished by d 

* 

The assembler answers with one asterisk for each legal input, and 
continues: 

*LIST- 

The user may respond with a decimal number terminated by T, R 
or £ , according to the choice of an assembly listing produced on 
the Teletype, on the High-Speed Punch, or not at all. The number 
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specifies the number of initial lines of the source program which 
are excluded from the listing; the user may use this feature in 
order to avoid unnecessary listing and thus speed-up the assembly 
operation. 

When this option of skipping initial program lines is intended, 
the pseudo-instruction XLIST should appear at the begin of the 
source program. In fact, the LIST-option works by issuing this 
command after completion of the specified count of lines. With 
this count being zero or not specified, the operation in this 
respect will be sensed by the user as normal DEC-PALD operation 
(though listing will be interrupted after 1+096 lines). 

♦SYMT- 

The user types X if the extended symbol table is intended, or ^ 
if not. The assembler then starts the assembly process, asking 
for punched tape inputs by typing 'j’; to which the user, after 
loading the current reader, answers by a CTRL/P key-in. For 
further information on assembler operation, refer to the DEC- 
PALD manual. 

Saving parts of the symbol table on DECtape will particularly 
impede the producing of an alphabetic list of symbols, since 
in the sorting process the whole table has to be searched once 
for each item listed. In order to circumvent this,the symbol 
list will be split in two, one for those symbols which are in 
core, and a second one for those saved on DECtape. Thus no time 
will be lost in swapping during this part of the assembly. 

The option of an extended symbol table will also influence the 
output to DECtape: the produced B-file is built-up of 1-block 
segments instead of 2-blocks. This may increase the amount of 
DECtape movements during assembly. In order to avoid this the 
user should arrange for separate DECtape units being used for 
storage of symbol table, input files, and output files. 
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^+ i _Crea^i.ng_tlie_DETEF—PALD file 

DETEF-PALD is obtained from a punched tape comprising three 
binaries by the following procedure: 

1) Load binary no. 1 

2) Save PAL011-6577j5000 

3) Load binary no. 2 

4) Save PALI 22400-2422,4066-4503;7777 

5) Load binary no. 3 

6) Save PAL2S2U11-2761;7777 

7) Allocate L PAID.'4$; 7777 

8) Add to Library PALD: PAL020, PALI.'33, PAL2!37 

In order that the symbol table extension may be saved on a DEC- 
tape unit other than the no. 0, the following patch has to be 
made to the C-file PALI before adding to the library file (use 
the program OEDT): 

block no. STBL+2, loc.no. 13: change 0000 to x000, 'x' de¬ 
noting an octal numeral. The symbol table will then be saved 
on DECtape unit no. x. 
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Appendix 1 


/ 

' ' . ) 

TABLE OF PAL INSTRUCTIONS AND PSEUDO INSTRUCTIONS 


I. INSTRUCTIONS 


AND* 

0000 

SMA* 

7500 

MQL* 

7421 

PCF* 

6022 

TAD= 

1000 

SZA* 

7440 

LSR* 

741 7 

PPC* 

6024 

I SZ= 

2000 

SPA* * 

7510 

ASR* 

741 5 

PLS* 

6026 

DC A* 

3000 

SNA* 

7450 

SHL* 

741 3 

KSF* 

6031 

JMS= 

4000 

SNL* 

7420 

NMI* 

741 1 

KCC* 

60 32 

JMP* 

5000 

SZL* 

7430 

DVI* 

740 7 

KRS* 

6034 

IOT= 

6000 

SKP* 

7410 

DTLB* 

6774 

KRB* 

6036 

OPR* 

7000 

QSR* 

7404 

DTRB* 

6772 

TSF* 

6041 

NOP= 

7000 

HLT* 

7402 

DTSF* 

6771 

TCF* 

6042 

CLA= 

7200 

CIA* 

7041 

OTXA* 

6764 

TPC* 

6044 

CLL = 

7100 

LAS* 

760 4 

DTCA* 

6762 

TLS* 

6046 

CMA* 

7040 

STA* 

7240 

DTRA* 

6761 

RDF* 

6214 

CML* 

7020 

STL* 

7120 

ION* 

6001 

RIF* 

6224 

RAR= 

7010 

GLK* 

720 4 

IOF* 

6002 

RMF* 

6244 

RTR= 

- 701 2 

SCL* 

740 3 

RSF* 

6011 

RIB* 

6234 

HAL* 

7004 

SCA= 

7441 

RRB* 

6012 

CDF* 

6201 

RTL= 

7006 

MOA* 

7501 

RFC* 

6014 ’ 

Cl F* 

6202 

lA.Cs 

7001 

MUY* 

740 5 

, PSF* 

6021 

1 



II. SPECIAL CHARACTERS AND PSEUDO INSTRUCTIONS 


OCTAL ’ 

DECIMAL 
TEXT 
XL I ST 

FIXTAB . ' • 

EXPUNG ' 

PAUSE , 

PAGE 

FIELD , 

/ 

**, & $ ' j C ( ! * • • = Z I - ♦ (SPACE) 

/ 


V 


r 
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The DECtape File-handling System "DETEF" 

Users Manual of April 7. 1972 

Revision of Oct., 1972 

ERRATA 


Page 

13 

line 

15: 

change *7744* 

to 

. 7745 . 

ft 

14 

ft 

15: 

" '6* 

It 

*5’ 

ft 

16 

tl 

13: 

" M65' 

?t 

* 164* 

ft 

16 

ft 

14: 

" ' 122 ' 

ft 

' 124' 

ft 

18 

ft 

31-32 

should read: 




*... by typing an octal location number 

( 0 - 200 ) and a "/”* reading the 

Page 20 line 1: delete 1 origins ...,' 

28 " 5 : change '7435* to * 7 ^ 36 * 

28 " 9: " *464' " »U65* 

34 " 12: append ' ; command "EXIT 

34 " 14: " '; start System at 7777' 
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